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Abstract 


Well-known BGP communities are manipulated differently across various 


current implementations, 


resulting in difficulties for operators. 


Network operators should deploy consistent community handling across 
their networks while taking the inconsistent behaviors from the 


various BGP implementations into consideration. 
recommends specific actions to limit future inconsistency: 


This document 
namely, 


BGP implementors must not create further inconsistencies from this 


point forward. 
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1. Introduction 


The BGP Communities attribute was specified in [RFC1997], which 
introduced the concept of well-known communities. In hindsight, 
[RFC1997] did not prescribe as fully as it should have how well-known 
communities may be manipulated by policies applied by operators. 
Currently, implementations differ in this regard, and these 
differences can result in inconsistent behaviors that operators find 
difficult to identify and resolve. 


This document describes the current behavioral differences in order 
to assist operators in generating consistent community-manipulation 
policies in a multi-vendor environment and to prevent the 
introduction of additional divergence in implementations. 


This document recommends specific actions to limit future 
inconsistency: namely, BGP implementors MUST NOT create further 
inconsistencies from this point forward. 
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The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 
"SHOULD", “SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and 
"OPTIONAL" in this document are to be interpreted as described in 
BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all 
capitals, as shown here. 


2. Manipulation of Communities by Policy 
[RFC1997] says: 


A BGP speaker receiving a route with the COMMUNITIES path 
attribute may modify this attribute according to the local policy. 


One basic operational need is to add or remove one or more 


communities to or from the set. The focus of this document is 
another common operational need: to replace all communities with a 
new set. To simplify this second case, most BGP policy 


implementations provide a syntax to "set" a community that operators 
use to mean "remove any/all communities present on the route and 
apply this set of communities instead". 


Some operators prefer to write explicit policy to delete unwanted 


communities rather than use "set", i.e., using "delete community *:*" 
and then "add community x:y ..." configuration statements in an 
attempt to replace all communities. The same community-manipulation 
policy differences described in the following section exist in the 
syntax for both "set" and "delete community *:*". For simplicity, 
the remainder of this document refers only to the "set" behaviors, 
which we refer to collectively as each implementation’s ’"set" 
directive’. 

3. Community Manipulation Policy Differences 


Vendor implementations differ in the treatment of certain well-known 
communities when modified using the syntax to "set" the community. 
Some replace all communities, including the well-known ones, with the 
new set; others replace all non-well-known communities but do not 
modify any well-known communities that are present. 


These differences result in what would appear to be identical policy 
configurations having very different results on different platforms. 
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4. Documentation of Vendor Implementations 


In this section, we document the syntax and observed behavior of the 
"set" directive in several popular BGP implementations to illustrate 
the severity of the problem operators face. 


In Juniper Networks’ Junos OS, "community set" removes all 
communities, well-known or otherwise. 


In Cisco IOS XR, "set community" removes all communities except for 
the following: 


+------------- +----------------------------------- + 
Numeric Common Name 
+------------- +----------------------------------- + 
0:0 internet 
6553920 graceful-shutdown 
65535:1 accept-own rfc7611 
65535:65281 NO_EXPORT 
65535:65282 NO_ADVERTISE 
65535:65283 NO_EXPORT_SUBCONFED (or local-AS) 


+------------- 4+----------------------------------- + 
Table 1: Communities Not Removed by Cisco’s IOS XR 


Cisco IOS XR allows well-known communities to be removed only by 
explicitly enumerating one at a time and not in the aggregate -- for 
xample, "delete community accept-own". Operators are advised to 
consult Cisco IOS XR documentation and/or Cisco support for full 
details. 


On Extreme networks’ Brocade NetIron, "set community X" removes all 
communities and sets X. 


In Huawei’s VRP product, "community set" removes all communities, 
well-known or otherwise. 


In OpenBGPD, "set community" does not remove any communities, well- 
known or otherwise. 


Nokia’s SR OS has several directives that operate on communities. 
Its "set" directive is called using the "replace" keyword, replacing 
all communities, well-known or otherwise, with the specified 
communities. 
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4.1. Note on an Inconsistency 
IANA publishes a list of well-known communities [IANA-WKC]. 


Cisco IOS XR’s set of well-known communities that "set community" 
will not overwrite diverges from the IANA’s list of well-known 
communities. Quite a few well-known communities from IANA’s list do 
not receive special treatment in Cisco IOS XR, and at least one 
community on Cisco IOS XR’s special treatment list, internet == 0:0, 
is not formally a well-known community as it is not in [IANA-WKC] (it 
is taken from the Reserved range [0x00000000-Ox0000FFFF]). 


This merely notes an inconsistency. It is not a plea to protect the 
entire IANA list from "set community". 


5. Note for Those Writing RFCs for New Community-Like Attributes 
When establishing new attributes similar to those in [RFC1997] (large 
communities, wide communities, etc.), RFC authors should state 
explicitly how the new attribute is to be handled. 


6. Action Items 


Network operators are encouraged to limit their use of the "set" 
directive (within reason) to improve consistency across platforms. 


Unfortunately, it would be operationally disruptive for vendors to 
change their current implementations. 


Vendors MUST clearly document the behavior of the "set" directive in 
their implementations. 


Vendors MUST ensure that their implementations’ "set" directive 
treatment of any specific community does not change if/when that 
community becomes a new well-known community through future 
standardization. For most implementations, this means that the "set" 
directive MUST continue to remove the community; for those 
implementations where the "set" directive removes no communities, 
that behavior MUST continue. 


Given the implementation inconsistencies described in this document, 
network operators are urged never to rely on any implicit 
understanding of a neighbor ASN’s BGP community handling. That is, 
before announcing prefixes with NO_EXPORT or any other community to a 
neighbor ASN, the operator should confirm with that neighbor how the 
community will be treated. 
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Considerations 


Surprising defaults and/or undocumented behaviors are not good for 


security. 


8. IANA Cons 


This document attempts to remedy that. 


iderations 


The IANA has listed this document as an additional reference for the 


[IANA-WKC] registry. 
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